home *** CD-ROM | disk | FTP | other *** search
/ ftp.hypersurf.com / ftp.hypersurf.com.tar / ftp.hypersurf.com / pub / mac / weather / WeatherTracker_2.2.4(FAT).hqx / WeatherTracker / WeatherTracker Help < prev    next >
Text File  |  1996-11-03  |  13KB  |  273 lines

  1. Introduction    
  2.  
  3. WeatherTracker allows you to connect to an Internet weather server to get current weather information and forecasts for a specified city.  It requires a 68020 or higher with System 7.0 and MacTCP or OpenTransport. WeatherTracker is shareware -- see the notice at the end of this document regarding payment.
  4.  
  5.  
  6. What happened to MacWeather, NetWeather, and MacWx?
  7.  
  8. Previous versions were called MacWeather, but since Accu-Weather holds a registered trademark for MacWeather¿, so I changed the name to NetWeather. Shortly after changing to NetWeather, I was informed that AccuWeather also holds a trademark for netWeather¿. I then changed the name to MacWx, but they thought that was too close to MacWeather since WX is an abbreviation for weather.  So far, there are no objections to WeatherTracker, so keep your fingers crossed.
  9.  
  10.  
  11. What is MacTCP?
  12.  
  13. MacTCP is an extension that provides the Macintosh implementation of TCP/IP, a communications protocol which allows your computer to talk to other computers on the Internet. In order to use MacTCP, you must have some type of connection to the Internet -- either through a direct Ethernet connection or from a dial-up service with SLIP or PPP capabilities. MacTCP is included in System 7.5, but you need to do a custom install to get it. You may also get MacTCP from the book Internet Starter Kit for Macintosh by Adam Engst. This book is also an excellent resource for people new to the Internet and provides far more information on getting connected than I could ever include here.
  14.  
  15.  
  16. What about OpenTransport?
  17.  
  18. OpenTransport is the new replacement for the aging MacTCP. It is included with
  19. PCI-based Macintoshes and is also available in System 7.5.3 (System 7.5 Update 2.0). OpenTransport provides the same TCP/IP connectivity as MacTCP, but with a friendlier interface and much improved performance for PowerPC-based computers. WeatherTracker currently only supports OpenTransport in PowerPC native mode. (This is on the advice of Apple, which has stated that OpenTransport may not be compatible with 68K computers running MacOS 8.) WeatherTracker will still work on 68K Macs running OpenTransport, but the networking calls will be done in TCP Classic mode.
  20.  
  21.  
  22. Getting Started
  23.  
  24. When WeatherTracker runs for the first time, it will attempt to connect to the weather server and retrieve current information for the default city, Washington, DC. You can cancel this process at any time by pressing command-period or the escape key. Registered users can define their own set of cities to view by choosing the City List menu item in the Edit menu. Add cities to the Current Cities list by selecting the appropriate country, state and city from the popup menus. When you are done, click the OK button.
  25.  
  26. Now you need to set the preferences by choosing the Preferences menu item in the Edit menu. Use the popup menu to select the City preferences panel. The Get Weather checkbox controls which cities actually get new information from the weather server. You may want to have five cities in your list, but only get current information on two of them, saving the others for special occasions. To reduce loads on the weather servers, please limit yourself to at most two active cities. When you are done setting preferences, click the OK button to save them.
  27.  
  28. To get new information immediately, choose the Force Update menu item in the Weather menu. Current weather conditions will be obtained for each of the active cities in your list. You should not need to use the Force Update command again since WeatherTracker automatically contacts the weather server every hour to request new information.
  29.  
  30.  
  31. Features
  32.  
  33. The following is an explanation of the major features of WeatherTracker. Extensive Balloon Help is also available to give specific help on any area you desire.
  34.  
  35. The large analog window is your main display for city conditions:
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61. Double-clicking within the various panels will bring up the preferences window for the area of interest. If desktop space is scarce, you can view the data in a smaller "digital" window:
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72. For those who want the smallest possible window footprint, there is also a new "tiny" window:
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81. Cities are selected using the Add City item in the Edit menu. You may have as many cities selected as you want, limited only by the amount of memory allocated to WeatherTracker. There are separate preferences available for each city. In the City Preferences, click the Get Weather checkbox to select whether new reports are to be retreived for a particular city. The weather servers are already heavily loaded, so I ask that you only get information for at most two cities in your list of selected cities.
  82.  
  83. Every hour, WeatherTracker will contact the weather server and download the latest information for the selected cities. If a server is not responding, WeatherTracker will cycle through the list of servers from the Network Preferences until a working server is found. For cities in the United States and Canada, local forecasts are automatically downloaded with the current weather conditions. Forecasts are not available from the weather server for cities outside the United States and Canada.
  84.  
  85. Near shore marine forecasts are also available for selected cities in coastal areas of the United States. To retrieve marine forecasts, click the Get Marine Forecast checkbox in the City  Preferences.
  86.  
  87. Climate data is available for many cities in the United States. To retrieve climate data, click the Get Climate Data checkbox in the City Selection Preferences card. The data that is reported varies greatly depending on the city. Some cities do not report climate data; others report daily temperatures and sunrise/sunset information; still others give detailed reports of the recent trends in the local weather.
  88.  
  89. The local forecast, marine forecast, and climate data call all be copied to the clipboard, saved as TeachText documents, or printed at any time.
  90.  
  91.  
  92. Getting Help    
  93.  
  94. Extensive balloon help is available to give brief descriptions of the various commands and their actions. This text is also accessible online by choosing the WeatherTracker Help item in the Balloon Help menu.
  95.  
  96.  
  97. Using Other Servers    
  98.  
  99. WeatherTracker is currently configured to work only on rainmaker.wunderground.com. It may also work on any of the following servers:
  100.    downwind.sprl.umich.edu
  101.    madlab.sprl.umich.edu
  102.    um-weather.sprl.umich.edu
  103. Please note that these servers are no longer suitable for non-interactive users (such as WeatherTracker users). The server administrators will be randomly changing the interface in such as way as to cause any program that attemps to connect non-interactively to fail to retrieve data. This may have the side effect of causing WeatherTracker to crash or lock up as it looks for non-existant prompts. The rainmaker server will should be the only server that you need to use. I am not aware of any other servers currently in operation that give comparable data.
  104.  
  105.  
  106. Firewall Users
  107.  
  108. Due to the limited scope of the telnet proxy hack that was in previous versions, firewall support has been removed for this version. I had planned to add support for SOCKS proxy, but time constraints prevented its inclusion. SOCKS will be included in the near future.
  109.  
  110.  
  111. Version History
  112.  
  113. 2.2.4    November 3, 1996
  114.     Ñ    fixed crash on disconnect for 68K users
  115.  
  116. 2.2.3    November 2, 1996
  117.     Ñ    Kagi shareware payment system begun
  118.     Ñ    fixed problems with some New York cities
  119.     Ñ    updated to CodeWarrior 10
  120.  
  121. 2.2.2    September 17, 1996
  122.     Ñ    fixed problems with European data
  123.  
  124. 2.2.1    August 29, 1996
  125.     Ñ    unregistered users can get data for any city, but no automatic updates
  126.     Ñ    unregistered users cannot save prefs on quit
  127.     Ñ    fixed bug which cut off "M" in AM/PM in tiny window
  128.     Ñ    fixed bug which caused city to be skipped if conditions were N/A
  129.     Ñ    added networking classes 7/18/96 bug fix
  130.  
  131. 2.2    July 4, 1996
  132.     Ñ    All users can access rainmaker.wunderground.com, but only registered users can
  133.       change the list of cities to view.
  134.  
  135. 2.1.8    June 12, 1996
  136.     Ñ    TCP networking now works again. Curses to 2's Complement!
  137.  
  138. 2.1.7    June 11, 1996
  139.     Ñ    Fixed problems when retrieving multiple cities
  140.     Ñ    Fixed problem with selections in text windows with multiple cities
  141.     Ñ    Added sanity checks around parsing routines
  142.  
  143. 2.1.6  June 5, 1996
  144.     Ñ    Renamed MacWx
  145.     Ñ    Updated to CodeWarrior 9
  146.     Ñ    Fixed parsing for many cities in Alaska
  147.     Ñ    Full text editing support is back in place
  148.  
  149. 2.1.5    May 23, 1996
  150.     Ñ    Increased speed when many fonts installed
  151.     
  152. 2.1.4    April 27, 1996
  153.     Ñ    Replaced text engine with standard TextEdit calls
  154.     Ñ    Fixed several memory-related bugs
  155.     Ñ    Added support for new port on rainmaker.wunderground.com
  156.     Ñ    Added registration codes
  157.     Ñ    Added preferences panel for font selection
  158.  
  159. 2.1.3    April 11, 1996
  160.     Ñ    Renamed NetWeather
  161.     Ñ    Corrected problems with forecasts in the Dallas, TX area
  162.     Ñ    Updated text engine to support word wrap.
  163.     Ñ    Added lots of debugging checks around data retrieval and parsing routines.
  164.  
  165. 2.1.2    March 28, 1996
  166.     Ñ    Preferences file conversion removed. Still too many bugs
  167.     Ñ    Use Logfile now works on PowerPCs
  168.     Ñ    Min/max work correctly.
  169.     Ñ    Get Marine and Get Climate now get the proper data.
  170.     Ñ    Cities are no longer skipped if the time stamp is the same.
  171.     Ñ    um-weather now connects on port 3001 instead of 3000.
  172.     Ñ    Non-US/Canada cities now work
  173.     Ñ    Data is updated after changing the city list
  174.     Ñ    Wind chill is not calculated for speeds below 5 mph
  175.  
  176. 2.1.1    March 25, 1996
  177.     Ñ    Fixed a bug with drawing text in 68K version
  178.  
  179. 2.1        March 25, 1996
  180.     Ñ    Rewritten for PowerPlant
  181.     Ñ    Newly styled windows
  182.     Ñ    Support for multiple cities
  183.     Ñ    Logging of data to files
  184.     Ñ    Daily min/max for thermometer and barometer
  185.     Ñ    Wind chill, heat index, and dewpoint
  186.     Ñ    Time stamp supports Date & Time control panel settings
  187.  
  188. 2.0.4   August 28, 1994
  189.     Ñ    Many spelling corrections
  190.     Ñ    Updated cities for newly supported major cities
  191.     Ñ    Increased width of digital window slightly to accomodate longer conditions
  192.     Ñ    MacWeather FAQ now included
  193.  
  194. 2.0.3    August 4, 1994
  195.     Ñ    Special release for Internet Starter Kit
  196.     Ñ    Fixed a few typos
  197.     Ñ    Window title now updated when starting a connection
  198.  
  199. 2.0.2    July 25, 1994
  200.     Ñ    Removed PowerPC native code -- lots more testing necessary
  201.  
  202. 2.0.1    July 25, 1994
  203.     Ñ    Fixed a bug which caused crashes when parsing forecasts
  204.  
  205. 2.0        July 24, 1994
  206.     Ñ    Added support for hPa and km/h
  207.     Ñ    Added support for tons of new cities in the US and abroad
  208.     Ñ    Added support for near-short marine forecasts in the US
  209.     Ñ    Added support for climatic data in the US
  210.     Ñ    Added nighttime icons
  211.     Ñ    Added support for saving and printing forecasts
  212.     Ñ    Added Recent menu to switch between cities easily
  213.     Ñ    Added Default button for preferences
  214.     Ñ    Added support for firewalls (still buggy)
  215.     Ñ    Added units to wind speed display
  216.     Ñ    Redrew displays to make them look a little better
  217.     Ñ    Numerous minor bug fixes
  218.  
  219. 1.1.1  March 8, 1994
  220.     Ñ    Fixed a bug caused by the last bug fix when conditions hadn't changed
  221.     Ñ    Fixed a bug with mouse clicks in the City Code edit field
  222.  
  223. 1.1   March 7, 1994
  224.     Ñ    Enabled copying from forecast window
  225.     Ñ    Rewrote icon picking code -- hopefully it now recognizes most of them
  226.     Ñ    Removed alert message for no icon available
  227.     Ñ    Fixed a few bugs related to edit boxes in the prefs window
  228.     Ñ    Added Location menu
  229.     Ñ    Fixed a bug which caused the forecast to be erased when conditions hadn't changed
  230.     Ñ    Added smaller digital display
  231.  
  232. 1.0   February 27, 1994
  233.     Ñ    First public release
  234.  
  235.  
  236. To Do List    
  237.  
  238. Ñ    SOCKS support
  239. Ñ    Support for Apple Script
  240. Ñ    Support for Apple Guide
  241. Ñ    Option to put temperature (or whatever you want) in menu bar
  242. Ñ    Clean up of data presented in the various forecast windows
  243.  
  244.  
  245. Shareware Notice    
  246.  
  247. Shareware registration for WeatherTracker is now being handled through Kagi. To register, run the "Register" program included with this distribution. Fill in your home and email addresses. Type in the number of copies (US$15 each) you would like to register in the box next to "Single User". Site licenses and worldwide licenses are also available, but most users will not need those. Select your payment method and provide any additional information as requested. When you are done, print out the form and send it to:
  248.  
  249. Kagi Shareware
  250. 1442-A Walnut Street #392-HX
  251. Berkeley, California, 94709-1405
  252. USA
  253. FAX: +1 510 652 6589
  254.  
  255. Online registration is also available for credit card and First Virtual accounts at:
  256. <http://kagi.direct.net/cgi-bin/register1.cgi?HX>
  257.  
  258.  
  259. Acknowledgements of payment are sent from Kagi when they are processed (usually within one week of receipt). When I am notified of your payment, I will send you a registration code via email. After you enter this code, WeatherTracker will save your preferences when you quit. If you do not get an acknowledgement from Kagi, you can contact them at <shareware@kagi.com>. Should you have any other problems with the registration process, feel free to contact me at <weathertracker@kagi.com>.
  260.  
  261. Current information can be found on the WeatherTracker  home page at
  262. <http://chemgod.slip.umd.edu/~kidwell/weather.html>
  263.  
  264. Please send any bug reports to:
  265. weathertracker@kagi.com
  266.  
  267.  
  268. WeatherTracker is Copyright ⌐ 1994-1996 by Christopher Kidwell. All rights reserved.
  269. WeatherTracker may be distributed freely as long as it is not modified in any way.
  270.